home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / pcbuda20.zip / PCBUDA.DOC < prev    next >
Text File  |  1993-06-03  |  11KB  |  244 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.               U p l o a d   /   D o w n l o a d   A n a l y z e r
  9.  
  10.                                   ( PCBUDA.EXE )
  11.                               =====================
  12.  
  13.  
  14.                                    Release 2.0
  15.  
  16.  
  17.                                 September 28, 1988
  18.  
  19.  
  20.                                   Clint Labarthe
  21.                                Copyright (C),  1988
  22.  
  23.  
  24.                      Black Hole BBS, Longwood, Florida 32750
  25.  
  26.                              Node 1 BBS 407-260-6397
  27.  
  28.                              Node 2 By Subscription
  29.  
  30.                              300/1200/2400 24 Hours
  31.  
  32.  
  33.  
  34.  
  35.  
  36. Overview
  37. ========
  38.  
  39. PCBUDA is a PCBoard SysOp utility to enhance your ability to control the
  40. behavior of your callers.  Specifically targeted are those callers that
  41. seem to have forgotten that there is a "U" key on their keyboard.  They
  42. seem to use the "D" key constantly.  We have many names for these callers
  43. from leaches to rapists.  The bottom line is that although you have given
  44. them amble opportunity to stay within your specified tolerances, they
  45. seem to go right along and download to their hearts content.  This program
  46. puts an end to this entire mess.  You may loose some callers but then you
  47. didn't really need that "type" of caller anyway did you ?
  48.  
  49. PCBSM from the staff at Salt Air provides some of what we need to control
  50. the environment of our callers.  Unfortunately, it does not provide the
  51. flexibility that I require.  Nor should it.  The Salt Air folks have to
  52. provide us general-use utilities.  If they provided everything everyone
  53. wanted, we would be swamped.  Given all of this, I made some basic
  54. assumptions.  First and foremost; this program is not for everyone.
  55. But if you find some feature that you believe would benefit all of us then
  56. please let me know.
  57.  
  58.  
  59. How it works
  60. ============
  61.  
  62. This utility will DENY download capability for a caller based upon a
  63. specified ratio that you define.  The utility will also REINSTATE
  64. a caller to the level they previously had once their ratio is within
  65. your pre-defined tolerances.  Now you might ask, how did I accomplish
  66. this ? Well, it isn't very fancy - but it does work !
  67.  
  68. What is required is intelligence in the PWRD (or whatever you call it) file.
  69. Those security levels within the PWRD file that are to be "monitored"
  70. by PCBUDA must have a corresponding security level entry that does not
  71. allow downloads.  Yes, I know that the "D" command security level is
  72. controlled by the PCBSetup program.  We are taking a different approach here.
  73. We are simply going to allow ZERO bytes for downloading to those security
  74. levels that we "link" to. Below is an example of my PWRD file.  I have
  75. deleted those entries used by the SysOp for obvious reasons.
  76.  
  77. Take a look at levels 9 and 10.  Those levels belong to the same "level"
  78. of caller.  If the caller downloads too much and exceeds the ratio then
  79. the program will give them a level 9.  Once their ratio is within that
  80. specified by you, then the program will reinstate them to level 10.
  81. The "linking" mechanism used is this:  a level which DENYS downloads ends
  82. in a nine (9). Therefore level 9, 19, 29, 39, 49, 59, 69, 79, 89
  83. could be used.  The next higher level is the level to be used when the
  84. caller is found to be WITHIN the specified ratio.  What this all means
  85. can be shown on the next page:
  86.  
  87.                           Security Levels
  88.  
  89.                     Downloads        Downloads
  90.                     Denied           Permitted
  91.                     ==========================
  92.                        9                 10
  93.                                          20  <=== bypassed
  94.                                          25  <=== bypassed
  95.                       29                 30
  96.                       49                 50
  97.                                          65 =
  98.                                          70    \
  99.                                          75       >-------- bypassed
  100.                                          80    /
  101.                                          85 =
  102.  
  103. In the above example, there is not a level in the PWRD file for 39.
  104. Therefore the program bypasses the 39 and 40 combination. Only when
  105. a level which ends in a "9" is found, is the next higher level used
  106. (as long as it does not also end in a "9").  Therefore levels
  107. 9 & 10 are linked, 29 and 30 are linked and so are 49 & 50.
  108. Since no others have a corresponding link they are bypassed by the
  109. program when it executes.
  110.  
  111. The entries within PWRD MUST be in ascending sequence by level.
  112.  
  113. Black Hole BBS PWRD file (partial)
  114. ==================================
  115.  
  116.      ,0,31,0           <=== Lock-out level
  117.      ,5,31,200         <=== Initial level before caller uses PCBNUR Door
  118.      ,9,31,0           <=== Registered level - DENIED downloads
  119.      ,10,31,200        <=== Registered level - downloads ALLOWED
  120.      ,20,46,300        <=== Co-Workers       - downloads ALLOWED
  121.      ,25,46,300        <=== AT&T Management  - downloads ALLOWED
  122.      ,29,46,0          <=== Visiting SysOp   - downloads DENIED
  123.      ,30,46,325        <=== Visiting SysOp   - downloads ALLOWED
  124.      ,49,61,0          <=== Subscriber - downloads DENIED
  125.      ,50,61,375        <=== Subscriber - downloads ALLOWED
  126.      ,65,91,500        <=== Node 2 Subscriber - downloads ALLOWED
  127.      ,70,91,500        <=== Node 2 AT&T Co-Worker - downloads ALLOWED
  128.      ,75,91,500        <=== Node 2 AT&T Management - downloads ALLOWED
  129.      ,80,91,500        <=== Node 2 Visiting SysOp - downloads ALLOWED
  130.  
  131.  
  132. Example Bulletin from the Black Hole BBS
  133. ========================================
  134.  
  135. ╔══[ Bulletin # 7, Black Hole BBS Security Levels ]═══════════════════════════╗
  136. ║                                          Time            Daily Download     ║
  137. ║  Level            Description         Allowed (min.)     Allocation (Bytes) ║
  138. ╟───────────────────────[ Node 1 Free Security Levels ]───────────────────────╢
  139. ║    5   New User                            30                    Zero       ║
  140. ║    9   Restricted (Too many Downloads)     30                    Zero       ║
  141. ║   10   Registered Caller                   30                 200,000       ║
  142. ║   20   Co-workers (Private)                45                 300,000       ║
  143. ║   25   AT&T Management (Private)           45                 300,000       ║
  144. ║   29   Restricted (Too many Downloads)     45                    Zero       ║
  145. ║   30   Visiting SysOp (Script #1)          45                 325,000       ║
  146. ║ 35-45  <unassigned>                   <unassigned>          <unassigned>    ║
  147. ╟─────────────[ Node 1 Security Level  -  $5.00 Annual donation ]─────────────╢
  148. ║   49   Restricted (Too many Downloads)     60                    Zero       ║
  149. ║   50   Node 1 Subscriber (Thanks!)         90                 375,000       ║
  150. ╟─────────────[ Node 2 Security Levels - $25.00 Annual donation ]─────────────╢
  151. ║   65   Node 2 Subscriber (Thanks!)         90                 500,000       ║
  152. ║   70   Co-workers (Private,Thanks!)        90                 500,000       ║
  153. ║   75   AT&T Management (Private,Thanks!)   90                 500,000       ║
  154. ║   80   Visiting SysOp (Script #1)          90                 500,000       ║
  155. ║   85 & up      <unpublished>          <unpublished>        <unpublished>    ║
  156. ╚═════════════════════════════════════════════════════════════════════════════╝
  157.  
  158. Running the program
  159. ===================
  160.  
  161. You may run the program from any directory you wish as long as you place
  162. the required PCBUDA.CFG file in the same directory. The structure of this
  163. configuration is detailed below.  You may also use the program to do
  164. "what if?" results without actually updating the USERS file. You do this
  165. analysis by passing a run-time parameter to the program. From the DOS
  166. prompt enter: PCBUDA ANALYZE
  167.  
  168. The PCBUDA program will run thru your entire USERS file and report on
  169. the local screen its findings based upon the requirements you specify
  170. in PCBUDA.CFG. Once you have your parameters set the way you want them
  171. you can run PCBUDA from the DOS command prompt without any parameters
  172. or you can do as I do and run the program daily in your event. The
  173. program will produce a Bulletin for you and a graphics version as well
  174. if you wish. The Bulletin details the "state" of your USERS file.
  175. As callers are reinstated they will be "dropped" from the Bulletin.
  176.  
  177. WARNING: If a new version of PCBoard is released, it is YOUR responsibility
  178.          to verify that the USERS file has not changed in structure
  179.          or layout. If it has, you will need a new version of the program.
  180.  
  181.  
  182. PCBUDA.CFG file structure  (to be placed in the same "default" directory.
  183. =========================
  184.  
  185. C:\PCB\PCBOARD.DAT        <=== The <path/name> of PCBOARD.DAT
  186. 15                        <=== The MAXIMUM ratio allowed (15 to 1)
  187. 10                        <=== The amount of FREE downloads BEFORE calculation
  188. D:\GEN\BLT99              <=== Bulletin to be created
  189. Y                         <=== A "Y" here creates a GRAPHICS bulletin as well
  190.  
  191. Disclaimer Of Liability
  192. =======================
  193.  
  194.         This program has been tested on PCBoard 14.0 ONLY !
  195.  
  196.         I assume no liability for its use in this or any other version
  197.         of PCBoard.  You may redistribute the
  198.         program to others so long as the code and the documentation  are
  199.         distributed together.  If  you  have  any  suggestions   for
  200.         improvements to this code, reply to the address below or call our
  201.         BBS   at  the  number  stated  above.   Please   complete   the
  202.         Registration form at the end of this documentation.  This program
  203.         is copyrighted.   It is unlawful to disassemble  or  otherwise
  204.         decode  or  misuse  the software contained herein.  It is for your
  205.         use and  may not be altered in an way.  You may not charge a fee  for
  206.         its  use  or sell it.  PCBUDA20.ARC is to be distributed  in  its
  207.         ORIGINAL ARC format and contain ALL the original files.
  208.  
  209.                Send inquires to:   Clint Labarthe
  210.                                    P. O. Box 151445
  211.                                    Altamonte Springs, Florida, 32701-1445
  212.  
  213. Contents Of "PCBUDA20.ARC" File
  214. ===============================
  215.  
  216.               1.) PCBUDA.EXE         The execuable program
  217.               2.) PCBUDA.DOC         This documentation
  218.               3.) PCBUDA.CFG         An example of the required .CFG file
  219.               4.) READ.ME            If included, may contain last minute
  220.                                      information.
  221.  
  222.  
  223. Changes In This Release
  224. =======================
  225.  
  226. Initial release to the production environment.  Version 1.0 was
  227. a beta version under PCBoard 12.1.
  228.  
  229. The Future
  230. ==========
  231.  
  232. Some of you may want the capability to use PCBSM for some of your adjustments
  233. and PCBUDA for others. Given this possibility, I have considered not
  234. making the program determine for itself what the "linked" security
  235. levels are but rather have you place them all in the .CFG file.
  236. That may be more work for you, but it would give your more flexibility.
  237. I'd like to hear from you on which method would be best. Even if you
  238. like the current mechanism, the security levels could be specified
  239. in the .CFG making the program more flexible.  Before I change the
  240. code I want to know how you feel.
  241.  
  242.  
  243.  
  244.